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What is Waffle 
e Yet another library that abstracts the GL winsys 
interaction 


- It is not SDL, there is no input handling etc 
- Zero platform dependant code 


- Platform & winsys - purely a runtime decision 


Waffle API 


waffle_display_connect 
waffle_display_disconnect 
waffle_display_supports_context_api 
waffle_display_get_ native 


waffle_window_create 
waffle_window_destroy 
waffle_window_show 
waffle_window_swap_buffers 
waffle_window_get_native 


waffle_dl can_open 
waffle _dl_sym 
and a few others 


glx 


XOpenDisplay 
gliXChooseFBConfig 
glXGetFBConfigAttrib 
glXGetVisualFromFBConfig 
glXCreateNewContext 

xcb create _ window checked 


cgl 


CGLChoosePixelFormat 
CGLCreateContext 
initWitnhFrame:NSMakeRect 


egl 


eglGetDisplay 
eglinitialize 
eglChooseConfig 
eglCreateContext 
egilCreateWindowSurface 


CreateWindow 
GetDC 
ChoosePixelFormat 
wglCreateContext 


Waffle 


waffle_init 

waffle display connect 
waffle config choose 
waffle context_create 
waffle _ window create 


Retro-fitting wgl into waffle 


waffle_display_connect 

- Create “root” window 

- Create a context an query the supported extensions 
waffle_config_choose 

- Create client window 

- Choose the config 

waffle_context_create 

- WglCreateContext 

waffle window create 

- ShowWindow 


Retro-fitting wgl into waffle(2) 


e A few extra quirks needed 


- wglGetProcAddress requires active context 


- dlopen/dlsym - LoadLibraryA/GetProcAddress and 
OpenGL ES”. 


Status 


e All the code is at github, to be merged soon ™ 


e Requires minor update of piglit, due to the 
wglGetProcAddress issue mentioned previously 


What's next 


e Get it upstream 
e Add the missing get_native hooks 


e Cleanup piglit to consistently use waffle and 
remove glut dependency 


e Add GL dispatch into waffle ? 
e Support for multi-monitor setups. 


Summary 


e Code is out there and works — tested against Windows Vista/7 on Nvidia 
based hardware 


piglit 228380530149, Windows 7 64bit, Nvidia GT 120M 
summary: 

pass: 10087 

fail: 1446 

crash: 24 

skip: 5306 

total: 16864 


* Beware - GPU lockups are common on Windows 


References 


e Waffle with WGL support 
https://github.com/evelikov/waffle/commits/yet-another-rou 
nd-of-msvc-fixes-1.2 


e Piglit with Waffle WGL 
https://github.com/evelikov/piglit/commits/waffle-WGL-1.2 


e How to build, use and package WGL enabled 
Waffle/piglit 
https://github.com/evelikov/waffle/releases/tag/v1.1 


